home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
qbbs
/
fsm340.zip
/
FSUMM.DOC
< prev
next >
Wrap
Text File
|
1991-03-30
|
20KB
|
336 lines
S/e/m/a/j Communications FileSummary Page 1
┌─▄█▀▀█▄────────────────────────────██─┐
│ ██ ██ ▄█▀▀█▄ ██▀██▀█▄ ▄█▀▀█▄ ██ │
│ ██ ██ ██ ██ ██ ██ ▀▀ ██ ██ │
│ ▀▀▀█▄ ██▀▀▀▀ ██ ██ ██ ▄█▀▀██ ██ │
│ ██ ██ ██ ██ ██ ██ ██ ██ █▄ ██ │
│ ██ ██ ▀█▄▄█▀ ██ ██ ██ ▀█▄▄██ ██ ██ │
└─▀█▄▄█▀────────────────────────▀█▄▄█▀─┘
S/e/m/a/j Communications
* Presents *
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
┌────█ ▐▌ █ ▐███▌ █ ▐ ▐▌ █▌ █ ▐ ▌ ▐▌ ▌ ▐ █ ▐ ▐▌ ▌ █ ▐█ ▐▌ █────┐
│ █ ▐███▌ █ ▐███▌ ████ ▐███▌ █▌ █ ▐▌ █ ▐▌ █ ▐▌ █ ▐█ ▐▌ █▌ █ ▐█ ▐▌ █ │
│ █ ▐ ▐▌ █ ▐███▌ ▌ █ ▐▌ █▌ █ ▐▌ █ ▐▌ █ ▐▌ █ ▐ ▐▌ ▌ █ ▐ ▐▌ █ │
│ █ ▐███▌ █ ▐███▌ ███████ ▐▌ █▌ █ ▐███ ▐▌ ███▌ █ ▐█ ▐▌ █ ▐████ ▐███ │
└────█ ▐███▌ █ ▐ ▐▌ ▌ █ ▐ ▐▌ ▌ █ ▐███ ▐▌ ███▌ █ ▐█ ▐▌ █▌ █ ▐▌ █────┘
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
·──── A Fast FILES.BBS Summary and AllFiles Lister for RemoteAccess BBS! ────·
Program Revision 3.40 is a MAJOR update... Please read these docs, and
the sample configuration file well. Upgrading may need a little work -
but it's worth it for the extra speed and *many* advanced features!!!!
** FileSummary now works with NOVELL NETWARE! **
NB! The control file has been renamed and is very different!
Some commands are gone, and there are many new ones. There's
fundamental changes with the Megalist-creating verbs, so you
may need to take a look at that (we now create any number of
lists, containing specific areas in each).
S/e/m/a/j Communications FileSummary Page 2
STANDARD DISCLAIMER (I'm sure you've seen it before somewhere)
~~~~~~~~~~~~~~~~~~~
This product is meant for educational purposes only. Any resemblance to
real persons, living or dead is purely coincidental. Void where
prohibited. Some assembly required. List each check separately by bank
number. Batteries not included. Contents may settle during shipment. Use
only as directed. No other warranty expressed or implied. Do not use
while operating a motor vehicle or heavy equipment. Postage will be paid
by addressee. Subject to CAB approval. This is not an offer to sell
securities. Apply only to affected area. May be too intense for some
viewers. Do not stamp. Use other side for additional listings. For
recreational use only. Do not disturb. All models over 18 years of age.
If condition persists, consult your physician. No user-serviceable parts
inside. Freshest if eaten before date on carton. Subject to change
without notice. Times approximate. Simulated picture. No postage
necessary if mailed in the United States. Breaking seal constitutes
acceptance of agreement. For off-road use only. As seen on TV. One size
fits all. Many suitcases look alike. Contains a substaintial amount of
non-tobacco ingredients. Colors may, in time, fade. We have sent the
forms which seem to be right for you. Slippery when wet. For office use
only. Not affiliated with the American Red Cross. Drop in any mailbox.
Edited for television. Keep cool; process promptly. Post office will not
deliver without postage. List was current at time of printing. Return to
sender, no forwarding order on file, unable to forward. Not responsible
for direct, indirect, incidental or consequential damages resulting from
any defect, error or failure to perform. At participating locations
only. Not the Beatles. Penalty for private use. See label for sequence.
Substantial penalty for early withdrawal. Do not write below this line.
Falling rock. Lost ticket pays maximum rate. Your cancelled check is
your receipt. Add toner. Place stamp here. Avoid contact with skin.
Sanitized for your protection. Be sure each item is properly endorsed.
Sign here without admitting guilt. Slightly higher west of the
Mississippi. Employees and their families are not eligible. Beware of
owl. Contestants have been briefed on some questions before the show.
Limited time offer, call now to insure prompt delivery. You must be
present to win. No passes accepted for this engagement. No purchase
necessary. Processed at location stamped in code at top of carton.
Shading within a garment may occur. Use only in well-ventilated area.
Keep away from fire or flame. Replace with same type. Approved for
veterans. Booths for two or more. Check here if tax deductible. Some
equipment shown is optional. Price does not include taxes. No Canadian
coins. Not recommended for children. Prerecorded for this time zone.
Reproduction strictly prohibited. No solicitors. No alcohol, dogs, or
horses. No anchovies unless otherwise specified. Restaurant package, not
for resale. List at least two alternate dates. First pull up, then pull
down. Call toll free before digging. Driver does not carry cash. Some of
the trademarks mentioned in this product appear for identification
purposes only. Record additional transactions on back of previous stub.
This supersedes all previous notices.
S/e/m/a/j Communications FileSummary Page 3
Disclaimer:
~~~~~~~~~~~
CREDITS!
~~~~~~~~
Documentation: (c) stuart henderson & MTD
≈dataMatrix≈ +44 392 434477
Standard Disclaimer: James found it hanging around somewhere
Program Code: (C) S/e/m/a/j Communications, 1990
Original Design: Martin Parry ■ Particle Programming
Author: James Berry
S/e/m/a/j ■ 0303 862415 ■ 2:440/16
Compiler: TopSpeed C, Jensen & Partners, International
RemoteAccess from: Continental Software
Introduction to S/e/m/a/j Communications
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
S/e/m/a/j Communications basically writes really neat little programs
generally intended to help sysops out. If you have a great idea for a
program then please send a message on to one of the beta testers who
will forward it via the SEMAJ.BETA echo to the author. If you are
interested in becoming a beta tester, please send James Berry (the
author) a netmail message to 2:440/16, or better still, ring up the
board and YELL for him. If you are accepted, you must be able to pick up
the SEMAJ.BETA echo from any existing beta-test site.
Copyright
~~~~~~~~~
Although these programs are distributed freely, it does not mean they
are in the public domain. You may use them for a trial period until you
have decided whether or not to register them. For details on
registration, please see the enclosed SEMAJ.REG file for more
information. This program is part of the special discount registration
scheme detailed in that file, as are most other S/e/m/a/j Communications
products (£20, which is approximately $40, for all current and future £5
registration S/e/m/a/j Communications programs. Even now there are
already more than 4 programs at the £5 fee so you can save money
already!)
CONTENTS!
~~~~~~~~~
The distribution archive is in "PkZip" format. It should only be
distributed in that format. The files in the archive should be the
following, and ONLY the following. If there are any other files added to
the archive, you should inform S/e/m/a/j Communications. Adding files to
the archive constitutes altering the program.
■──────────────┬───────────────────────────────────────────────────────┐
│ FBBSHEAD.FSM │ Demonstration Header File for your FILES.BBS │
│ FSUMM.CFG │ FileSummary Control File [can be renamed, read on] │
│ FSUMM.DOC │ The Documentation - What you're reading now! │
│ FSUMM.EXE │ The Main Program │
│ MEGAHEAD.FSM │ Demonstration Header File for the MegaList │
│ SEMAJ.REG │ Registration Form │
│ SEMAJ.LST │ List of Beta-Testers, reg'd users, support boards │
│ WARRANTY.DOC │ Your Guarantee │
└──────────────┴───────────────────────────────────────────────────────┘
S/e/m/a/j Communications FileSummary Page 4
What FileSummary Does, And Why It Exists
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
You will probably already have seen what FileSummary does to the
FILES.BBS while looking at a file list on a BBS that uses it. By
default, it inserts a little bit of information about the file area at
the beginning of FILES.BBS, including things like the area's name,
number of files in the area, and total space used by this area. It
scans your FILES.RA file (in the RA system directory) for all file areas
and edits the file listing in those areas. Note that although
FileSummary remembers which directory you started from on the current
drive, and leaves you there when it has finished, it may have changed
the directory on other drives mentioned in FILES.RA. FileSummary will
search for FILES.RA firstly in the current directory, and then in the
directory pointed to by the environment variable "RA".
Typical Non-FileSummarized, Sample FILES.BBS File
────────────────────────────────────────────────────────────────────────
3-DEMoN.ZiP [0] 3D Pac-man type game.
ABM.ZIP [00] Anti-Bolistic Missile game
aLleYCaT.ZIP [00] Get the rats in this arcade game
Antix.Zip [4] Another game from the author of Tetris
A Sample FILES.BBS File After FileSummarizing (slightly edited)
────────────────────────────────────────────────────────────────────────
-=- FileSummary v3.40ß -=-
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Files listing last updated on: Sun Jul 29 23:43:24 1990 █
█ █
█ File Directory: IBM Games █
█ Number of files found: 99 Total bytes: 43172338 █
█ █
█─────────┬───────┬────────┬──────────────────────────────────────────────█
█ File │ Size │ Date │ File Description █
══════════╧═══════╧════════╧═══════════════════════════════════════════════
3-DEMON.ZIP [00] 3D Pac-man type game.
ABM.ZIP [00] Anti-Bolistic Missile game
ALLEYCAT.ZIP [00] Get the rats in this arcade game
ANTIX.ZIP [04] Another game from the author of Tetris
A Sample FILES.BBS Being Displayed in RemoteAccess (slightly edited)
────────────────────────────────────────────────────────────────────────
-=- FileSummary v3.40ß -=-
█▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
█ Files listing last updated on: Sun Jul 29 23:43:24 1990 █
█ █
█ File Directory: IBM Games █
█ Number of files found: 99 Total bytes: 43172338 █
█ █
█─────────┬───────┬────────┬──────────────────────────────────────────────█
█ File │ Size │ Date │ File Description █
══════════╧═══════╧════════╧═══════════════════════════════════════════════
3-DEMON.ZIP 21147 04-12-90 [00] 3D Pac-man type game.
ABM.ZIP 24217 04-12-90 [00] Anti-Bolistic Missile game
ALLEYCAT.ZIP 35522 04-12-90 [00] Get the rats in this arcade game
ANTIX.ZIP 17647 05-05-89 [04] Another game from the author of Tetris
S/e/m/a/j Communications FileSummary Page 5
How do you run FileSummary?
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Basically, you change to the global RemoteAccess directory containing
FILES.RA and FSUMM.CFG, our special control file, and type or put in a
batch file the command to run FSUMM.EXE. Not all that tricky, eh?! You
must have no more than 128 characters (including any comments) in each
line of FILES.BBS. If you want to use a different config file name, then
specify it on the command line ie FSUMM E:\BETA\FSMCDROM.CFG..
You also need a header file if you intend on using the FILES.BBS headers
named with the AreaHeader verb. You may include the following macros in
the header file:
%DATE (24 characters) displays the current date and time in the output
%DIR (47 characters) displays the name of the area (right justified)
%LDIR (47 characters) displays the name of the area (left justified)
%FNO (3 characters) displays the number of files in the current area
%FBYTES (9 characters) displays the number of bytes used in the area
%DLOADS (4 characters) displays the number of downloads in the area
Before the header file is put in the FILES.BBS, there is an ID line that
lets FSUMM know that it has already processed that file. If, in the past
you have run FSUMM, the old header in the FILES.BBS file should be wiped
automatically anyway. But be on the safe side and check first though.
When FSUMM is run, a short file containing just a number will be created
in the directory it is run in (should always be your main RA directory).
Read the following sentence over to yourself until you understand it: DO
NOT DELETE THIS FILE. It is a special file used internally by FSUMM, and
if it is deleted your headers may appear twice or something wierd. This
file is called FSUMM.INF. Another file is created if you use the builtin
files-counter routine, FSUMM.MRK, and markers will be added to your log.
How do I make a FSUMM.CFG file?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Good question. It's an ordinary ASCII file with a few special commands
in; included with FileSummary is a sample of what you can use and what
the verbs do. Lines beginning with % or ; are ignored by FSUMM. You can
remove the comments from the sample file to speed up processing by quite
a large amount..
Please look at the sample control file for all the verbs, there are full
descriptions in it as well.
This is just the command set available for this version of FileSummary.
Who knows what will be in the next version! If you have any ideas, then
please contact James Berry on S/e/m/a/j, the S/e/m/a/j Communications
Support Board: 0303 862415, FidoNet 2:440/16.
That's also the number to call (or FidoNet address to send mail to) if
you have any bug reports, constructive criticisms, etc.
See SEMAJ.LST for a list of BBS where you may find latest releases.
S/e/m/a/j Communications FileSummary Page 6
An Example Of FILES.BBS Sorting
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Before -
■──────────────────────────────────────────────────────────────────────┐
│ * S/e/m/a/j Communications Files - Release Versions │
│ │
│ BBS100.ZIP BBSort - Sorts your FILES.BBS │
│ RAB102.ZIP RA BitLoc - Unlocks COM-Port for doors │
│ AM200.ZIP AutoMsg - Sends msgs to newusers, etc │
│ FSM320.ZIP FSummary - Another FILES.BBS utility │
│ │
│ * S/e/m/a/j Communications Files - ßeta Test - Password Protected │
│ │
│ RCV110.ZIP new rarcv │
│ FSM330.ZIP the best just gets better... │
│ NLL120.ZIP create text file from nodelist │
└──────────────────────────────────────────────────────────────────────┘
- After -
■──────────────────────────────────────────────────────────────────────┐
│ * S/e/m/a/j Communications Files - Release Versions │
│ │
│ AM200.ZIP AutoMsg - Sends msgs to newusers, etc │
│ BBS100.ZIP BBSort - Sorts your FILES.BBS │
│ FSM320.ZIP FSummary - Another FILES.BBS utility │
│ RAB102.ZIP RA BitLoc - Unlocks COM-Port for doors │
│ │
│ * S/e/m/a/j Communications Files - ßeta Test - Password Protected │
│ │
│ FSM330.ZIP the best just gets better... │
│ NLL120.ZIP create text file from nodelist │
│ RCV110.ZIP new rarcv │
└──────────────────────────────────────────────────────────────────────┘
Other Major S/e/m/a/j Products
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
AutoMsg 2.20 - The Automatic Message Generator - creates a variety of
messages for special occasions, for example new users and uploads. It
can also generate a daily information message to you, listing new users
and so on, the number of calls you've had, the amount of disk space
left, etc... And much, much, MUCH more!!! Release: IMMINENT!
RA BitLoc 1.10 - This utility will unlock your COM-port if you use a
locked com port to run doors. Many doors do not support speeds of more
than 19200bps but you need to lock your com-port at 38400bps with quite
a few modems to get best effects for file transfer. This will unlock the
speed down to the connect speed (registered users may 'lowlock' down to
19200bps for example). Uses DORINFO1.DEF as its interface file.
RA_Receive - Goes through the message base looking for unreceived
messages to anyone with a certain flag set in USERS.BBS in the areas
defined by you. It then marks them received. This is a great help if you
have sysops calling your board who have loads of echomail to wade
through before getting to local messages and so on.
(c) stuart henderson, 1991.
╔══════════════════════════════════════════════════════════════════════════╗
║*** A copy of the SOURCE CODE of any S/e/m/a/j utility is available on ***║
║*** ── request for the sum of £500 ── subject to authors discretion ── ***║
╚══════════════════════════════════════════════════════════════════════════╝